home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1995 August / macformat-027.iso / mac / Shareware City / Control Strip / Audio Strip GH 1.2 ƒ / Audio Strip GH -- Read Me < prev    next >
Encoding:
Text File  |  1995-04-20  |  10.3 KB  |  184 lines  |  [TEXT/ttxt]

  1.                                     Audio Strip GH v. 1.2
  2.                                                                                                                                                                                                 by
  3.                                                          Glenn R. Howes
  4.                                                                                                 grhowes@students.wisc.edu
  5. What it is:
  6.   Audio Strip GH is a collection of 11 Control Strip modules which implement the controls on a CD player: play, stop, eject, volume, pause/continue, fast forward, fast backward, skip to next  track, skip to previous track, display time and one module which does most everything. 
  7.   
  8.   It should work with any drive which uses Apple's CD-ROM driver (although, the volume control will not work with the CDSC drive). It also works with most but not all non-Apple drivers.
  9.  
  10. What does it cost:
  11.   Audio Strip was originally freeware, and the  original modules still are. The newer modules are stored in an encrypted archive. If you want to use these, you will have to send me $10 for the password.
  12.  
  13.  If you want to use the modules in the encrypted archive, send $10 U.S to:
  14.  
  15.   Glenn R. Howes
  16.   726 W. Main #301
  17.   Madison, WI 53715
  18.  
  19. If you send a valid, Internet-reachable, e-mail address, I will send the password that way, thus saving time.
  20.  
  21. I would be happy to license  all the modules to drive makers, or resellers of the Control Strip.
  22. _________________________________________________________________
  23. Changes since 1.1
  24.   • Added program support for track programs created with the AppleCD Audio Player v2.0.
  25.   • Now store track name strings so has to avoid rebuilding track menu every time omni module is clicked. 
  26.   • Fixed cosmetic bug in all  modules when the module's display area was cut off.
  27.   • Fixed bug in the omni module where  it wouldn't stop some CDs.
  28.   • Worked around difference between how Apple driver responds to the order of play/stop commands and how the APS PowerTools v3.0.7 responds. This was making it impossible to use the shift key to play only one track in the Play module.
  29.   • Worked around lack of fast forward/fast reverse support in Toshiba drives.
  30.  
  31. Changes since 1.0
  32.   • Got rid of silly button on button look of the modules Finder icons
  33.     (rebuild your desktop to see changes).
  34.   • Added Fast Forward, Fast Reverse, Next Track, and Previous Track modules,
  35.     I now emulate every commonly present CD control. The user of course should
  36.     feel no compulsion to use all or most of the modules.
  37.         • Added Time/Volume display module.
  38.   • Added "Auto Repeat CD" option to the omni module.
  39.   • Added "Auto Eject CD" option to the omni module
  40.   • Added multiple drive support to all modules.
  41.         • Added balloon help strings.
  42.      • Tracks that begin with "-" (hyphen) will no longer show up as an unselectable
  43.      gray line.
  44.         •    Replaced numbered menu of volumes with a graphical sliding menu (with continuously 
  45.     changing volume).
  46.   • All modules now based on the same generic audio cd module code framework to
  47.      improve maintainability.
  48.   • Eject should no longer allow ejecting the drive when the file sharing bug is 
  49.      holding it captive.
  50.   • Added disk name to top of track list menu.
  51. _________________________________________________________________
  52.  
  53. How to install:
  54. First, you must have the Apple Control Strip loaded. It is part of the System 7.5 release. It is also available with a set of commercial utilities called PBTools. The free utility Control Strip Patcher will allow you to use the Control Strip with desktop machines. Men & Mice are  distributing a compatible product called "Desktop Strip" as shareware.
  55.   
  56. To extract the encrypted modules:
  57. The modules are stored in a self extracting Stuffit Deluxe archive. Double click on the "Encrypted Modules.sea" and you will be asked for a password, which you can obtain by sending me $10 U.S (see "What does it cost" above). Be sure to enter the password exactly as given.
  58.  
  59. For those concerned with screen space:
  60. Drag CD Omni GH into the "Control Strip Modules" folder inside your System folder and restart.
  61.   
  62. For those with plenty of screen space:
  63. Drag any combination of CD Volume GH, CD Play GH, CD Eject GH, CD Pause GH, CD Last GH, CD Next GH, CD Omni GH, CD Scan Down GH, CD Scan Up GH, CD Time GH or CD Stop GH into the "Control Strip Modules" folder inside your System Folder and restart. 
  64.  
  65.                                                                                                 **You don't have to install all the modules.**
  66.                                                                 ** I use the omni, eject, volume, time and next track modules.**
  67.   
  68.   If the modules find a valid Apple CD ROM drive on your primary SCSI chain,  they will appear in your control strip.  They also works with most compatible drives. 
  69.  
  70. How to use:
  71. All modules: 
  72. Command clicking will bring up a menu which allows you to select which of the CD drives on the primary SCSI bus the module will be associated with. If you have more than one CD drive, you can make duplicates of modules and associate the duplicates with different drives.
  73.  
  74.  
  75. Omni module (3 icons:X, right triangle or 2 Rectangles; with mini icons on bottom):         
  76. Command clicking will bring up a menu with items:
  77.    Auto Play CD:                  When selected, module will try to play an audio cd on    insertion.
  78.    Auto Repeat CD:      When selected, module will keep playing the cd over and over.
  79.             Auto Eject CD:                 When selected, module will eject when play has stopped. 
  80.                                         unless it conflicts with auto repeating.
  81.       Use Program:        When selected, module will use the AppleCD track programs.
  82. -------------------
  83.         SCSI ID# 1
  84.         SCSI ID#5            Choose which drive this module commands. You can make copies 
  85.                                                                                                                                                                 of this module so as to control multiple drives.
  86.  
  87. ** note: The Fast Forward ,Fast Reverse, Play, and Next modules when used can and will confuse the Omni module while in program mode, and the module will use more CPU time while in program mode **
  88.  
  89. If the cd is stopped, quickly clicking on the triangle icon will start playing the audio cd     from the beginning of the CD or AppleCD program (if Use Program is in affect).
  90.                          
  91. If the cd is paused, quickly clicking on the triangle icon will continue playing from the paused position.
  92.                          
  93. If the cd is playing, quickly clicking on the double rectangles will pause the cd.
  94.                          
  95. If there isn't an audio cd in the drive, clicking and holding will bring up a menu with one item (eject).
  96.                          
  97. If you click and hold for a half second while playing, a menu will appear with a list of  tracks, an option to eject, an option  to pause or continue, and an option to stop. If you've used the Apple CD Player application to enter the track names, the menu will be in the form of track names, otherwise it wil be in the form of a list of track numbers. If you click and hold with the shift key down, only the track you select will be played. If the Use Programs option is in affect or the shift key is down, the track list will the program list if available.
  98.                          
  99. If you click and hold with the control key down, you will be given a menu from which to select a new sound level. (will not work on CDSC).
  100.                          
  101.       *** the omni & display modules asks the cd player for its state every 2 seconds***
  102.                                                       *** the other modules use up little computing time  ***
  103.  
  104.  
  105. Up + Down Triangles:   
  106.                 Clicking on this icon and holding will bring up a menu, which you can use to set the CD's sound level (wont work on CDSC).  
  107.                          
  108. Triangle:
  109. Clicking on this icon and holding will bring up a  menu of the possible tracks to start playing from. (if you hold down the shift key while selecting  a track, only that track will be played).   
  110.                          
  111. Square:
  112. Clicking on this icon will stop the cd's playing.  
  113.    
  114. Triangle + Rectangle:
  115. Clicking on this icon should eject the cd.(Command Click: select drive)   
  116. **warning: does not differentiate between audio & other CD's**.
  117.                             
  118. Verical Rectangles:   
  119. Clicking on this icon while a track is playing will put the CD into a pause state. Clicking again while in this state will continue playing from the original point.  
  120.                          
  121. Double Left Triangle: 
  122. Clicking and holding on this icon will do a fast rewind as long as the button is being pushed.  
  123.                             
  124. Double Right Triangle:
  125. Clicking and holding on this icon will do a fast forward as long as the button is being pushed.    
  126.                             
  127. 2 Left Triangles+ Rectangle:     
  128. Clicking on this button will go to the beginning of the previous track. 
  129.    
  130. 2 Right Triangles+ Rectangle:
  131. Clicking on this button will go to the beginning of the next track.    
  132.  
  133. Track + Time + Sound Level Display: 
  134. Clicking on this module will bring up a menu of times to display
  135. and which of the available disks to monitor:
  136.            menu item                                                                                        mini icon in display
  137.             Time Left in Track            ==>                 open circle + down arrow
  138.    Time Left in Disk                    ==>                    full circle + down arrow
  139.             Time into Track                            ==>                    open circle + up arrow
  140.          Time into Disk                                    ==>                    full circle + up arrow
  141.  
  142. In the upper left corner of this module, the current track is displayed
  143. in boldface. If the drive is stopped or an audio cd isn't present, there
  144. will be two hyphens (--).
  145.  
  146. In the lower right portion of the module, the current playback time is
  147. displayed; which playback time is used depends on the settings of the 
  148. preference menu. If the drive is stopped or an audio cd isn't present, 
  149. "--:--" will be displayed.
  150.  
  151. On my system (U.S.A Roman), there is room for 5 small boxes over the
  152. time display, which are used to display the current sound level if the 
  153. selected drive supports software sound level control.
  154.  
  155. If assumptions I made about font sizes affects non-USA systems, please
  156. let me know.
  157.  
  158. Warranty:
  159.   There is none. Any damage caused by using this software is
  160.   the responsibility & problem of the user.
  161.  
  162. Report Bugs/ Feature Requests:
  163.   Internet: grhowes@students.wisc.edu
  164.  
  165. Look for:
  166.  My AppleScript Audio CD extension: AudioCDgh.
  167.  My home page: http://www.xraylith.wisc.edu/~howes/
  168.  
  169. Written In:
  170.   C using the Codewarrior DR\5 release.
  171.   
  172. Thanks to:
  173.  My beta testers especially Troy Gaul who nagged me into the omni module.
  174.  
  175.  Leonard Roesenthol for pointing out the flicker free beauty of the srcCopy
  176. text mode.
  177.  
  178.  Martin Minow for providing the world with the controlstrip.h file, without which
  179.  writing these modules would be somewhat iffy.
  180.  
  181.  The good folks of Pious the X Grade School in Billings, MT, where I went to
  182.  1st -> 3rd grade. I hope you are still in business.
  183.  
  184.